SCHED: RecreatePossibilities
Format
SCHED / RecreatePossibilities {AttributeName} <Parameters>
Description
The RecreatePossibilities command will make Scheduler recalculate all possibilities for all tasks in a schedule. Note that by default (and if no additional attributes are included), the resource usage settings (such as capacity, setup time, etc.) will also be reset to their default values based on the resources used for that possibility. Including additional attributes will allow you to retain certain resource usage settings, or allow you to only recreate possibilities for a certain set of tasks.
Parameters
| {AttributeName} | <Parameters> | Parameters Values |
|---|---|---|
| RetainSettings | <RetainSettings> | If the RetainSettings parameter is TRUE (or not included with command), then all tasks' possibilities
will attempt to re-create their resource usage attributes while retaining their current settings as they
existed immediately prior to this command.
If the RetainSettings parameter is FALSE, then all task' possibilities will re-create their resource usage attributes from their related resource object values. To partially retain resource usage settings, use a comma delimited list of resource usage setting subgroups. The subgroups are Capacity (for all settings related to capacity), SetupBreakdownTimes (for setup and breakdown times), Cost, Priority (for possibility and timeslot priorities), STKReports (for STK reports used to limit timeslots), TimeReports (for window files used to limit timeslots), and Other (for Animation, Report Definition, Is Accommodation Applicable, and Override Task Duration). |
| Names | <Names> | The Names argument is an optional comma delimited list of tasks that will have their possibilities re-created. If not present, then all task possibilities will re-created. This value must be in single quotes. |
| ApplyBufferTime | <Time> | The ApplyBufferTime argument will lock any task using a buffer time enabled resource, or all tasks that fall into the schedule level buffer time. Then it will recreate all of the tasks that happens after the buffer time. Options for this parameter are Now, or a time in one of the formats listed on the DateFormats page. |
| RetainAssignments | True/False/Adjust | If the RetainAssignments parameter is TRUE, then tasks will attempt to keep their current assignments after possibilities are recreated. This may result in violations if these assignments are no longer valid. Recurring tasks may have their assignments reassigned to different children, or may not be able to retain all assignments if there are not enough child tasks after recreating possibilities. If the RetainAssignments parameter is FALSE, then all assignments will be unassigned from tasks when their possibilities are recreated. This is the default behavior. If the RetainAssignments parameter is ADJUST, it will be treated as TRUE, but additionally this command will attempt to adjust task assignments to fit within any altered timeslots. This may result in violations if altering these assignments causes resources to be utilized in an invalid manner. |
Examples
Re-creates possibilities for DemoTask1 and DemoTask2 while retaining resource usage settings
SCHED / RecreatePossibilities RetainSettings True Names 'DemoTask1, DemoTask2'
| Syntax | Example |
|---|---|
| <CommandName> | SCHED / RecreatePossibilities |
| <RetainSettings> | True |
| <Names> | 'DemoTask1, DemoTask2' |
Re-creates possibilities for all tasks while retaining resource usage settings only for capacity and resource priority
SCHED / RecreatePossibilities RetainSettings Capacity,Priority
| Syntax | Example |
|---|---|
| <CommandName> | SCHED / RecreatePossibilities |
| <RetainSettings> | Capacity,Priority |
Return Message
If activated, Connect returns an acknowledgment message.
Group Membership
This command belongs to the following group(s):
Version
5.0
